home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 38 / Amiga Format CD38 (1999-03-15)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-04].iso / -seriously_amiga- / misc / openlibpatch / openlibpatch.readme < prev    next >
Text File  |  1999-02-03  |  4KB  |  114 lines
  1. Short    :    Fakes OpenLibrary() to open any version
  2. Author    :    Marcin Orlowski <carlos@amiga.com.pl>
  3. Uploader:    Marcin Orlowski <carlos@amiga.com.pl>
  4. Type    :    util/libs
  5. Date    :    Fri Jan 29 11:29:57 1999
  6. Version    :    0.1
  7.  
  8.  
  9.  INTRODUCTION
  10.  -----------------
  11.  
  12.  It seems not many OS 3.1 equipped Amiga programmers know, that while
  13.  OS 3.0 was released, CBM (or whatever) did NOT bump version numbers
  14.  of all OS components to v39. Due to this bug, if you target you app
  15.  for OS 3.0 and above, you HAVE TO make sure, your program does NOT
  16.  require all libraries with version 39.
  17.  
  18.  Hopefuly this 'version incompatibility' causes problems under very
  19.  rare circumstances. As far as I know, you should remember, the
  20.  following components of OS3.0 are not version 39:
  21.  
  22.   - keymap.library (is v37)
  23.  
  24.  This 'list' is not complete, but I don't expect it to be much
  25.  larger. But it's their fault for sure, and it's up to you to work
  26.  that around.
  27.  
  28.  HOW?  If you are programmer:  MAKE SURE YOU DO NOT DECLARE
  29.  __oslibversion 39 IF YOU USE ANY OF MENTIONED LIBRARIES.
  30.  Better lower the limit to 37 and e.g.  match exec library against v39
  31.  by hand for instance.
  32.  
  33.  If you are NOT programmer: keymap.library resides in ROM, so don't
  34.  look for it in LIBS: drawer. Either hardware (ROM) update, or soft
  35.  kicked 3.1 can upgrade it.
  36.  
  37.  
  38.  AFFECTED PROGRAMS 
  39.  ------------------
  40.  
  41.  Hopefuly not many. So far I saw two:
  42.  
  43.   - Amiga VNC client (VAA) (take a look: http://www.orl.co.uk/vnc/)
  44.   - very early AWeb 0.x or something (mentioned for statistics only ;-)
  45.  
  46.  
  47.  WHY I CREATED IT?
  48.  ------------------
  49.  
  50.  Because VVA's author seems to have network problems and my bug reports
  51.  bounced. And I wanted to launch VNC ASAP. That's the story behing ;-)
  52.  
  53.  
  54.  SO, WHAT DOES IT DO?
  55.  ----------------------
  56.  
  57.  If you find any program that refuses to launch on your (mostly 3.0)
  58.  system, and you are sure, it should work, first, check if you got all
  59.  external files it wants like fonts etc (SnoopDos rules -> take it
  60.  from Aminet).  Then if all files are available, check (SnoopDos
  61.  again) if the program does not attempt to open any of the above
  62.  mentioned libraries with inproper, unavailable on your system, version.
  63.  If you discover it does, launch OpenLibPatch and try again.
  64.  If that was the only reasonif failed, it should be cured now.
  65.  I suggest to quit or disable OpenLibPatch as soon as you launch 'bad'
  66.  program.
  67.  
  68.  
  69.  TECHNICAL?
  70.  --------------------------------
  71.  
  72.  OpenLibPatch is a commodity driven patch.  You can remove,
  73.  disable and enable it using Exchange - standard system tool.  When
  74.  the patch active (in Exchange - commodity is active), it
  75.  redirects all OpenLibrary() call to OldOpenLibrary(name), which allows
  76.  you to open any version of library if it exists. No matter what version
  77.  you really have.  When disabled, it does nothing of course, except calling
  78.  original OpenLibrary() function with passed arguments
  79.  
  80.  NOTE: this may cause your system to crash, if you try to launch OS3.x
  81.        program on your OS2.0 equipped machine!  OpenLibPatch does NOT add
  82.        any feature to your outdated system, just fools it a bit!.  Better
  83.        upgrade to OS3.x and sleep well ;-)
  84.  
  85.  
  86.  REQUIREMENTS
  87.  ----------------------
  88.  
  89.  OS 2.x or better (for presence of commodities.library)
  90.  
  91.  
  92.  BUGS?
  93.  --------------------------------
  94.  
  95.  No check is made while removing the patch.  So if anything else
  96.  (SnoopDos for instance) patched OpenLibrary() too, you should quit
  97.  it BEFORE you quit OpenLibPatch or Guru may drop you a visit. 
  98.  Yes, I know there is many software managers that helps solving this
  99.  problem but I don't plan to develop this program any longer - it
  100.  was quick hack for the needs.
  101.  
  102.  
  103.  LEGAL MUMBO JUMBO
  104.  --------------------------------
  105.  
  106.  This program is written and copyrighted by Marcin Orlowski
  107.  <carlos@amiga.com.pl>. You may use it free of charge, spread, peek,
  108.  poke, crunch, rename, delete, resource etc - I don't care.  If it
  109.  crash your system or cause any data loss -> it's NOT my fault!
  110.  
  111.  Use this software at your own risk.
  112.  
  113.  Amen.
  114.